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PDP-8/15 TRANSLATOR (8TRAN) - A program 
which assists users in converting PDP-8 software for 
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CHAPTER 1 
INTRODUCTION 

PDP-15 8TRAN is a relocatable program which assists in the translation of PDP-8 programs to PDP-15 programs. 
8TRAN accepts source coding in PAL-III, PAL-D, or MACRO -8 assembly languages and produces source code in 
MACRO-15 or CAP- 15 assembly languages. Its main functions are: 

Re-formatting of statements 

Translation of mnemonics 

Insertion of flags to indicate either that instructions have been translated or that translation is 
impossible. 



NOTE 

EAE coding and any input/output instructions other than 
those for the reader/punch and Teletype must be modi- 
fied. Floating point instructions are translated to con- 
form to the PDP- 15/10 COMPACT Software System. 
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2. 1 MEMORY REFERENCE INSTRUCTIONS 

Table 2-1 shows the correspondence between the two sets, 



CHAPTER 2 
INSTRUCTION SETS 



Table 2-1 
Correspondence Between Memory Reference Instructions 



PDP- 


•8 


PDF 


'-15 


Mnemonic 


Octal 


Mnemonic 


Octal 


AND 


0000 


AND 


500000 


TAD 


1000 


TAD 


340000 


ISZ 


2000 


ISZ 


440000 


JMS 


4000 


JMS 


100000 


J MP 


5000 


JMP 


600000 


DCA 


3000 


DAC 
CLA 


040000 






CAL 


000000 






DZM 


140000 






LAC 


200000 






XOR 


240000 






ADD 


300000 






XCT 


400000 






SAD 


540000 



2.2 INDIRECT REFERENCES AND AUTO-INDEX REGISTERS 
Single level indirect addressing is identical on both machines. 

PDP-8 



0400 



PDP-15 



020000 
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The Auto-Index Registers (10-17) also operate identically. However, the PDP-8 has one set of Auto Index 
Registers for each 8K memory field, while the PDP-15 has only one set of Auto Index Registers in Page of 
Bank 0. 

2.3 OPERATE INSTRUCTIONS 

A single group of Operate instructions in PDP-15 corresponds to the two groups in PDP-8, as shown in Table 2-2, 

Table 2-2 
Correspondence Between Operate Instructions 



PDP-8 


PDP-15 


Group 1 


NOPorOPR 


7000 


NOP or OPR 


740000 




CLA 


7200 


CLA 


750000 




CLL 


7100 


CLL 


744000 




CMA 


7040 


CMA 


740001 




CML 


7020 


CtAl 


740002 




RAR 


7010 


RAR 


740020 




RAL 


7004 


RAL 


740010 




RTR 


7012 


RTR 


472020 




RTL 


7006 


RTL 


742010 




IAC 


7001 


IAC 


740030 


Group 2 


CLA 


7600 


CLA 


750000 




SMA 


7500 


SMA 


740100 




SZA 


7440 


SZA 


740200 




SNL 


7420 


SNL 


740400 




SPA 


7510 


SPA 


741100 




SNA 


7450 


SNA 


741200 




SZL 


7430 


SZL 


741400 




SKP 


7410 


SKP 


741000 




OSR 


7404 


OAS 


740004 




HLT 


7402 


HLT 


740040 



2.4 LAW INSTRUCTION 

The LAW instruction in PDP-15 has no equivalent in PDP-8. The mnemonic LAW N has an octal value of 760000 
+ N. 



2.5 PAGING 

The address portion of Memory Reference Instructions consists of 8 bits on the PDP-8 and 12 bits on the PDP-15, 
permitting direct addressing of 4K on the PDP-15. 

Using indirect address references, the address size is 12 bits in PDP-8 and up to 15 bits in PDP-15, so that data 
and instruction fields are not required in PDP-15. 
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CHAPTER 3 
ASSEMBLERS 

The symbolic programs acceptable to PAL IIl/MACRO-8 and to MACRO-15 are similar in most respects. The 
important differences which do exist are discussed in this chapter. 

3.1 FORMAT 

The MACRO-15 Assembler is field-oriented, which means that the interpretation of a statement depends on the 
field in which each element of the statement lies. There are four fields: 

LABEL (Field delimiter) 

OPERATION (Field delimiter) 

ADDRESS (Field delimiter) 

COMMENT (Statement delimiter) 

A field delimiter Is either a space or a tab. A statement delimiter is either a carriage return or a semicolon. In 
this document, tabs are indicated with the symbol -»| , and carriage returns are indicated with y . 

In MACRO-15, there is no field for an indirect reference because indirect addressing is indicated by an asterisk 
(*) immediately following the mnemonic operator in the operation field. 

Examples: 



PDP-8 
TAG, 



PDP-15 



TAD A 


TAG 


Htad 


HA 


ISZI B 




Hisz* 


Hb 


JMPC 




-*|JMP 


H-c 



Tabs are normally preferred to spaces as field delimiters. MACRO-15 does not require commas to terminate labels, 
Labels appearing on successive lines without any code are given consecutive addresses by MACRO-15, not the 
same address; an important difference from the PDP-8 assembler. 
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3.2 SYMBOLS 

Symbols in MACRO-15 may use period (.) and percent sign (%) in addition to letters and numbers. The initial 
character must be a letter, period (.), or percent sign (%). 

3.3 EXPRESSION OPERATORS 

MACRO-15 has a more extensive set of operators. Addition (+), Subtraction {-), AND (&), and Inclusive OR 
(!) are supplemented by Exclusive OR (\), Multiplication (*), and Division (/). 

3.4 NUMBERS 

18 17 

Octal and decimal numbers in the range ±2 -1 for unsigned integers and ±2 -1 for signed integers are avail- 
able in MACRO-15. Double precision and floating-point constants (DUBL and FLTG pseudo-ops of MACRO-8) 
are not permitted in MACRO-15. 

3.5 LOCATION COUNTER 

The Location Counter may be referenced by period (.) in both systems. It is set as follows: 



PDP-8 



~ n 
PAGE n 



PDP-15 



.LOC n 

Ignored 

Paging is redundant in 
PDP-15 



The Location Counter is advanced as follows: 



PDP-8 



+ n 



PDP-15 



. BLOCK n 



The .BLOCK pseudo-op makes the operation more explicit in PDP-15. 

3.6 TEXT HANDLING 

Pseudo-ops to perform packing of 6-bit trimmed ASCII characters are available in both systems 



PDP-8 



TEXT 



PDP-15 



.SIXBT 
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The 18-bit word in PDP-15 permits 3 characters per word, as compared with 2 characters per word in PDP-8. 

An additional pseudo-op which performs the packing of five 7-bit ASCII characters in two words (.ASCII) is 
available in PDP-15. 



3.7 TERMINATING PSEUDO-OPS 

The correspondence between the two systems is: 

PDP-8 



PAUSE 

$ 



PDP-15 



.EOT 
.END 



3.8 LITERALS 

Page zero literals have no meaning in PDP-15. The correspondence is: 



PDP-8 


PDP-15 


[ 


( 


( 


( 


] 


) 


) 


) 



It should be noted that neither nested literals, e.g., TAD (TAD (20)), nor 8-bit ASCII characters, e.g., TAD 
("A), are allowed in MACRO-15. 

3.9 SYMBOL TABLE 

The Symbol Table of MACRO-15 cannot be deleted, hence EXPUNGE is not a valid pseudo-op. 

Since the permanent Symbol Table of MACRO-15 is searched for octal matching and not symbol matching the 
pseudo-ops FIXMRI and FIXTAB are redundant. A memory reference instruction is defined by a parameter assign- 
ment, e.g., IDX=ISZ, or I DX -440000. 



3.10 USER MACROS 

User Macros can be more elaborate in MACRO-15. The correspondence between the sets is: 



PDP-8 



DEFINE 

< 
> 



PDP-15 



.DEFIN 
Not used 
.ENDM 
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Example: 



PDP-8 


PDP-15 


DEFINE SUB AB 


.DEFIN 


<CLA 


LAC 


TAD B 


CMA 


CIA 


TAD 


TAD A> 


TAD 




.ENDM 



SUB A,B 
B 

(1 
A 
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CHAPTER 4 
INPUT/OUTPUT 

The most important difference between the PDP-8 and the PDP-15 in I/O lies in the fact that an extra 3 bits 
(12-14) are available in the PDP-15 instruction word. 

Bits 12 and 13 are used for subdevice selection, and Bit 14, when set, clears the AC at event time 1; i.e., prior 
to transfers to/from the AC. 

4.1 FLAGS 

The PDP-15 has two instructions, not available on PDP-8, which read and clear flags. 



IORS 
CAF 



Input/Output Read Status 
Clear All Flags 



4.2 INTERRUPT 

The interrupt structure is identical on both machines. When the interrupt function is enabled (ION), the setting 
of a flag will cause an interrupt; i.e. , an effective JMS to location of field 0. 

The PDP-15 has an 18-bit word so that the full 15-bit address of the interrupt location is stored, eliminating the 
need for the 6-bit Interrupt Buffer in the PDP-8. 

The remaining 3 bits of the PDP-15 word are used to store the state of the Link, Bank/Page Mode, and Memory 
Protect. 

PDP-15 



L 


BPM 


MP 


ADDRESS (15-Bits) 



3-17 
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4.3 TELETYPE® 

There are two differences in the IOT instructions between PDP-8 and PDP-15. 

KCC does not exist on the PDP-15. The Keyboard Flag is cleared by issuing a KRB, which also reads the buffer. 

KRS (only recognized in the PDP-15/10 COMPACT System) performs the function of Keyboard Reader Select, a 
facility not available in PDP-8. 



PDP-8 



KCC 
KRS 



PDP-15 



None (use KRB) 
None (use KRB) 
KRS (Keyboard Reader Select) 



All other Teletype IOTs are identical. 



4.4 READER/PUNCH 



All reader/punch functions available on the PDP-8 are also available on the PDP-15. The PDP-8 operates in 
Alphanumeric mode only, while the PDP-15 operates in Binary mode as well as Alphanumeric mode. (Binary 
permits the reading of an 18-bit word from 3 lines of tape and the punching of a single line in the format of the 
binary read.) 



PDP-8 


PDP-15 


RSF 


RSF 


RRB 


RRB 


RFC 


RSA 


— 


RSB 


PLS 


PSA 


~ 


PSB 


PCF 


PCF 


PSF 


PSF 



4.5 DECTAPE 

The DECtape controllers, TC01 on PDP-8 and TC02 on PDP-15, work in an identical manner. 

The standard format of data on the tape differs significantly (see Table 4-1). There is, however, no incompati 
bility of control word format; therefore, a standard block of 129 words written by the PDP-8 can be read as a 
block of 86 words by the PDP-15. 



®r 



eletype is the registered trademark of Teletype Corporation 
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Table 4-1 
Tape Standard Data Format 




PDP-8 


PDP-15 


Words 
per Block 


12910 

(12 bits) 


256io 
(18 bits) 


Blocks 


0-2701 8 


o-iioi 8 


Address of 
Word Count 


7754 


30 


Address of 
Current Address 


7755 


31 



The instructions to the two controllers differ in only one respect. The single IOT DTSF (skip if error flag or DEC- 
tape control flag=l) in the TC01 is replaced by rhe two IOTs, DTDF (skip if DECtape control flag=l) and DTEF 
(skip if DECtape error f!ag=l), on the TC02. 

The two Status Registers, A and B, are 12 bits on both machines (AC ,, on the PDP-15). 

4.6 IOTs IN PERMANENT SYMBOL TABLE 

MACRO-15 assumes that input/output will be handled by I/O System Macros using device handlers. Device- 
dependent IOTs are therefore not included in the Symbol Table. The P (parameter) option in MACRO-15 provides 
the facility for adding to the Symbol Table prior to an assembly; IOTs may always be assigned in this manner if 
required. 
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CHAPTER 5 
EXTENDED ARITHMETIC ELEMENT 



Any EAE coding for the PDP-8 should be rewritten for the PDP-15, since: 

a. The word length on the two machines is different. 

b. The PDP-15 EAE is considerably more powerful than its PDP-8 counterpart, 

Table 5-1 indicates the correspondence between the two instruction sets. 



Table 5-1 
Correspondence Between Instruction Sets 



PDP-8 


PDP-15 


DVI 


DVI 


NMI 


NORM 


SHL 1 
N J 


LLS+N+1 


ASR ■> 
N J 


LRSS+N+ 


LSR I 
N J 


LRS+N+1 


MQL 


LMQ 


MUY 


MUL 


MQA 


OMQ 


CAM 


CLQ 


SCA 


OSC 



5. 1 MULTIPLICATION AND DIVISION 

Signed operations (MULS and DIVS) are available on PDP-15. The full number of shifts is always performed in 
multiplication and division on PDP-8. The number of shifts in PDP-15 is programmable (contained in bits 12-17 
of the instruction word) to reduce execution time where numbers are less than 18 bits in magnitude. 
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In division, the high order parr only or the lower order pari* only of the dividend may be used in the operation as 
alternatives to the usual double word operation. 

(IDIV, IDIVS, FRDIV, FRDIVS) 

5.2 SHIFTING 

Three additional shifting operations are available on PDP-15. They are: 

a. Signed left shifr (LLSS) 

b. Accumulator left shift (ALS) 

c. Signed accumulator left shift (ALSS). 
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CHAPTER 6 
FLOATING-POINT ARITHMETIC 



Both the format and the treatment of floating-point numbers are different on the two machines, 



6.1 FORMAT 



PDP-8 



SIGN 



SIGN 



Three- 


word 








Exponent 
2s Comp 




1 




11 






High-Order 
Mantissa 




1 




11 




Low-Order 
Mantissa 



11 



Mantissae are in 2s complement 



PDP-15 



Two-word 



Low -Order 
Mantissa 



Exponent 
2s Comp 







89 



17 



SIGN 



High-Order 
Mantissa 



1 



17 



SIGN 



Three - 


wore 






Exponent 
2s Comp 







17 




High-Order 
Mantissa 


1 




17 


Low Order 
Mantissa 



17 



Negative mantissae are indicated 
by setting bit of the high-order 
word (i.e, Sign-Magnitude nota- 
tion) 



6-1 



6.2 ARITHMETIC PACKAGE 

The PDP-8 performs floating-point arithmetic by use of an interpreter. The PDP-15 uses subroutine calls to 
perform its arithmetic, the address of the argument being in the location following the JMS. Indirect addresses 
are indicated by setting bit of the word (i.e., XCT). 

The correspondence between the two systems is shown in Table 6-1 . 



Table 6-1 
Correspondence Between Arithmetic Packages 



PDP-8 



JMS 17 (Enter Interpreter) 
FADD A 

FSUB I B 

FMPY 

FDIV 

FGET 

FPUT 

FNOR 

FEXT 



PDP-15 



None (not interpretive) 

JMS Hfad 

A 

JMS Hfsub 

XCT Hb * 

JMS Hfmpy 
JMS Hfdvd 

JMS HFLAC 

JMS Hfdac 

JMS H%FNOR 
None (not interpreted) 



6.3 INPUT/OUTPUT 

The PDP-15/10 COMPACT system has an I/O package similar to that of the PDP-8. Numbers are input to and 
output from the floating accumulator. 

The subroutine call for the PDP-15/10 is followed by an argument. On input, bit of the argument indicates 
the input device (other bits are ignored). On output, bit indicates the output device, the other bits indicate 
the number of digits in the mantissa output. 



PDP-8 



JMS I 5 
JMS I 6 



PDP-15 



fJMS Hflip 
I 

(JMS H FLOP 
6 



Floating-point constants must be changed, and where FLTG is used in MACRO-8 the appropriate octal numbers 
must be inserted. 
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Examples: 



Decimal 


PDP-8 


PDP-15 


0.1 


7775 


460775 




3146 


314631 




3146 




-7.0 


0003 


000003 




4400 


740000 




0000 




tr 


0002 


550002 




3110 


311037 




3755 




5.0 


FLTG 5.0 


000003 
240000 
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CHAPTER 7 
TRANSLATOR FUNCTIONS 

The Translator program accepts a symbolic source tape (or file) written in either PAL III, PAL D, or MACRO -8, 
and translates it to MACRO-15 or CAP-15 assembly language, within the limits described below. 

7.1 FORMATS 

Each statement is re-formatted in MACRO-15 format. The Translator inserts a tab after a label field and after 
the operation field, so that the MACRO-15 listing appears in columns as shown in the examples below. 



PDP-8 



TAG,CLACMA 
TAD I Z AUTO 



PDP-15 



TAG CLAICMA 

TAD* AUTO 



[The optional page zero indicator (Z) is ignored.] 



7.2 TRANSLATION 



The following translations are performed. (Mnemonics processed by the Translator, and their translation where 
appropriate, are listed in Appendix A.) 



7.2.1 Memory Reference Instructions 

PDP-8 



DCA LOC 



PDP-15 



fDAC 
\CLA 



Hloc 



Where DCA is followed by TAD, the CLA In the above translation may sometimes be eliminated. The Translator 
treats the situation in one of three ways: 
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PDP-8 




PDP-15 




DCA LOC 
TAD LOC 




DAC 


LOC 


DCA LOCI 
TAD LOC2 




DAC 
LAC 


LOCI 
LOC2 


DCA LOC 
TAG, TAD LOC 


TAG 


DAC 
CLA 
TAD 


LOC 
LOC 



In the last example above, the CLA is not eliminated because the TAD is labelled. 

Where successive DCAs are translated, DZM replaces each DCA after the first, terminating the last DZM with a 
CLA. If a DCA is tagged, however, DZM is not generated. 



PDP-8 



DCA LOCI 
DCA LOC2 
DCA LOC3 
TAG, DCA LOC4 
JMP LOC5 



All other MRIs are transferred without change 



7.2.2 Input/Output Instructions 



PDP-8 



PDP-15 



TAG 



DAC 


LOCI 


DZM 


LOC2 


DZM 


LOC3 


CLA 




DAC 


LOC4 


CLA 




JMP 


LOC5 



RFC 
PLS 



PDP-15 



RSA 
PSA 



All other Teletype and reader/punch instructions are transferred without change. IOT instructions for other de- 
vices are declared undefined symbols (see Paragraph 7.3. 1 .4). 



7-2 



7.2.3 Operate Instructions 



PDP-8 


PDP-15 


IAC 


IAC 


CLA IAC 


CLA! IAC 


CIA 


CMAIIAC 


CLL RTL 


CLL 




RTL 


OSR 


OAS 


CLA OSR 


LAS 



In addition to separating double-rotate instructions from other instructions because of conflicting event times, 
single-rotate instructions are also separated when they conflict. 

7.2.4 Pseudo-Operations 



7.2.4.1 Miscellaneous 



PDP-8 



DECIMAL 

OCTAL 

PAUSE 



PDP-15 



.DEC 
.OCT 
.EOT 
.END 



The PDP-8 pseudo-ops PAGE and * for setting the location counter are not translated 



7.2.4.2 Text Handling 



PDP-8 



TEXT 



PDP-15 



SIXBT 



Both .SIXBT in MACRO-15 and TEXT in PDP-8 assemblers treat text strings as trimmed ASCII. MACRO-15 stores 
three characters per 18-bit word. 

7.2.4.3 Macro Defining -The left angle bracket (<), used in MACRO-8, is ignored. However, instructions 
within a macro are translated. Since there is no macro facility in the CAP-15 Assembler, the 4K COMPACT 
version of 8TRAN ignores macro definitions. (Macro names, DEFINE or < > will be flagged as undefined symbols 
when encountered.) 
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PDP-8 

DEFINE 

< 
> 



PDP-15 

.DEFIN 
ignored 
.ENDM 



7.2.5 Literals 



PDP-8 


PDP-15 


[ 


( 


3 


) 


("N 


(nnn 



Page literals are translated as ordinary literals. Instructions within literals are translated. ASCII characters 
are translated into their 7-bit octal equivalent. 

7.2.6 Floating Point 



PDP-8 


PDP- 


-15 


FEXT 


Ignored 


FADD 


JMS 


H FAD 


FSUB 


JMS 


Hfsub 


FMPY 


JMS 


HfMPY 


FDIV 


JMS 


Hfdvd 


FGET 


JMS 


Hflac 


FPUT 


JMS 


Hfdac 


FNOR 


JMS 


H%FNOR 


I 


XCT 




JMS I 5 


JMS 


Hflip 




JMS I 6 


JMS 


Hflop 

6 


JMS I 7 


Ignored 



The calls to the Input/Output routines (JMS I 5 and JMS I 6) and the entry to the interpreter (JMS I 7) are 
frequently given other names by parameter assignment. Where these instructions occur in a parameter assignment, 
the following translations occur. 



7-4 



PDP-8 

JMS I 5 

JMS I 6 

JMS I 7 



PDP-15 
JMS HFLIP 

JMS Hflop 

NOP 



The arguments of JMS FLIP and JMS FLOP are dropped and any entry to the interpreter is effectively ignored. 
However, the input and output calls must be followed by arguments, so insertion would have to be made at ap- 
propriate points In the program. 

Floating-point variable storage can be reduced by one location for each variable, but no program error will oc- 
cur if this is not done. 



7.3 FLAGS 

Flags are inserted to signal translations (or the absence of a translation) which may result in incorrect operation 
when assembling on the PDP-15. A flag occurs as a comment after the relevant instruction, starting on a new 
line, and is always preceded by 

followed by a brief message, as defined below and summarized in Appendix B. inere are two types of flags, op- 
tional and mandatory. 

7.3.1 Optional Flags 

Optional flags may be suppressed by the user because the appearance of these flags does not necessarily mean 
that changes have to be made to the program. (The method of suppressing optional flags is explained in Chapter 
8.) The Translator may insert optional flags for the conditions described below. 

7.3.1 .1 Additional Code - When the Translator generates extra lines of code, a flag may be raised. The two 
situations are: 

DCA A DCA instruction was translated into DAC followed by CLA. 

SMI (Segmented Micro-instruction) - A segmented micro-instruction was encountered 

which could be translated only by splitting it into two instructions. 

7.3.1.2 Relative Addresses - Since extra lines of code are generated, any relative address which occurs in the 
program may be in error. 
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REL An address followed by ±n (where n is a number) was encountered. 

7.3. 1 .3 Rotate Instructions - Since the word length of the two machines is different, the use of rotate instruc- 
tions may result in incorrect operation. 

ROT A single or double rotate instruction was encountered. 

7.3. 1.4 Undefined Symbols - Since the Translator contains tables of pseudo-operations, Memory Reference, 
Operate, and Teletype and reader/punch I/O instructions only (the latter two being limited to CAP- 15), any 
other symbol encountered in the operation field is undefined. Provision is therefore included to read a User Syr 
bol Table prior to translation, so that a symbol is not declared undefined until a search of all user symbols has 

been made. 

US An undefined symbol was found in the operation field. 



NOTE 

1) If a User Symbol Table is to be retained for a number 
of tapes, each tape except the last must be terminated 
by a PAUSE pseudo-op. 

2) If a User Symbol Table is not read prior to translation, 
it will be built during translation; hence only forward 
references in the operation field will be flagged. 



7.3.2 Mandatory Flags 

The flags in this group are always typed when applicable. They are generated for the following reasons. 

7.3.2.1 Location Counter Settings - The setting of the location counter by PAGE and * is ignored, and the 
code is simply printed as a comment. 

LOC A location counter setting was ignored. 

NOTE 
Each translation is preceded by .ABS and .LOC 100. 

7.3.2.2 Illegal Characters - When an illegal character is encountered, its octal value in 7-bit ASCII is output 
The character is ignored. 



7-6 



IC nnn Illegal character. 

7.3.2.3 Literals - Instructions within literals are translated only if the translation comprises a single line of 
code. Nested literals are illegal in MACRO-15. 

LIT A literal was nested, or, if translated, would have produced extra code. 

7.3.2.4 Multiple Precision Constants - Double precision integers (DUBL) and floating-point constants (FLTG) 
have a different representation in PDP-15. They are not translated. 

MPC A DUBL or FLTG pseudo-operation was encountered and ignored. 

7.3.2.5 Skip Instructions - IF the instruction following a Skip instruction is segmented, the Skip will cause an 
error at execution: 

SKP A segmented micro-instruction followed a Skip instruction. 

7.3.2.6 Symbol Table Overflow - The symbol table capacity is 1024 symbols in the CAP-15 version, and all of 
the unused core between .SCOM+2 and .SCOM+-3 in the MACRO-15 version. If the symbol table is filled, no 
further symbols will be stored. 

SE Symbol Table Exceeded. 
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CHAPTER 8 
OPERATION 

8TRAN exists in three versions to allow operation in the various PDP-15 software environments. The Advanced 
and Background/Foreground Monitor version uses standard device handlers for I/O functions. The Basic I/O 
Monitor version is similar, differing only in the assignment of device handlers. The COMPACT version operates 
using its own embedded I/O functions. Appendix C provides a typical example of 8TRAN operation in the Ad- 
vanced Monitor Environment. 

8.1 MONITOR VERSIONS 

These versions of 8TRAN are relocatable binary paper tapes which must be loaded either by the Linking Loader 
or DDT. 

8.1.1 . DAT Slot Assignments 
The following .DAT slots are used: 



-15 Input 


(Default - 


- DTA2) 


-14 Output 


(Default ■ 


- DTA1) 


-3 Messages 


TTA 




-2 Command String 


TTA 




3 Input 


PRA 




5 Output 


PPA 





Advanced and Background/ 
Foreground version 

Advanced and Background/ 
Foreground version 

Both versions 

Both versions 

Basic I/O Monitor version 

Basic I/O Monitor version 



NOTE 

The Advanced and Background/Foreground version uses 
the system Macro .FSTAT. Any file oriented device 
handler used must recognize .FSTAT, otherwise an 
IOPS6 error will occur. 
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8.1.2 Loading Procedures 

8.1.2.1 Advanced and Background/Foreground Environment - When the Monitor is in core, perform the follow- 
ing steps: 

a. Assign .DAT slots (optional). 

b. Type: 

GLOAD^ 

c. When the Linking Loader is in core, it types: 

LOADER Vnn 

> 

d. If using Advanced Monitor, type: 

«- 8TRAN (ALT MODE) 
If using Background/Foreground Monitor, type: 
<*- 8TRAN (ALT MODE) 

e. When loaded, 8TRAN types: 

8TRAN Vnn 
> 

and waits for a command string (see Paragraph 8.1 .2.3). 

8. 1.2.2 Basic I/O Monitor Environment - Perform the following steps: 

a. Put the 8TRAN tape in the tape reader. 

b. Set the ADDRESS Switches to 17720 (8K). 

c. Press I/O RESET and READIN. 

d. When loaded, 8TRAN types 

8TRAN Vnn 
> 

and waits for command string (see Paragraph 8. 1.2.3). 

8. 1 .2.3 Command String - 8TRAN expects a command string in the following format: 



Options 


+— Filename } or 


(ALT MODE) 

a . Causes a return to the 
Monitor after translation 
is completed (Advanced 
and Background/Fore- 
ground). 

b. Halts 8TRAN when cur- 
rent translation is complete 
(press CONTINUE to restart). 


See Paragraph 8. 1 .3 


Restarts 8TRAN when 
current translation is 
completed. 
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8.1.3 Options 

There are two options in 8TRAN, which may be exercised separately or together: 

S Read a symbol table prior to translation. 

F Suppress output of flags. 

8. 1.3.1 Symbol Table - If S is typed, it must be followed by the name of the symbol table file. The file will 
be a symbol table output by either PAL III or MACRO-8. 

Example S <— SYMTAB ) 

The program reads the symbol table, stores it and types 

SYMBOL TABLE READ 

> 

The program now requires the name of the file to be translated, 
e.g., <-MAC8) or (ALT MODE) 

8.1.3.2 Flag Suppression - If F is typed, 8TRAN responds by typing FLAGS, after which it waits for the user 
to type any or all of the following 

DCA, REL, ROT, SMI, US, 

to suppress output of the corresponding flags. The flag names may appear in any order, separated by space or 
tab, and terminated by a carriage return. Example: 

FLAGS - DCA US REL ) 

8.1.4 Translation 

The program then proceeds to translate the file named in the command string. The file name extension for input 
is assumed to be SRC unless it is given in the command string. The file name extension on output will always be 
SRC irrespective of the extension given in the command string. It is recommended that the extension PAL be 
given to PDP-8 programs so that there will be no confusion between original and translated programs. 
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8.1.5 Other Features 

a. PAUSE - When a PAUSE is encountered, the symbol table Is preserved for the translation of other 
tapes. The program types: 

PAUSE 
> 

and waits for another command string. 

b. $ - If a $ is encountered in a translation where the last command string was terminated by ALT 
MODE, either the user is returned to the Monitor (Advanced and Background/Foreground Environment) or 
8TRAN restarts (Basic I/O Monitor Environment). If a $ is encountered when the last command string 
was terminated with ), 8TRAN restarts and types 

8TRAN Vnn 

> 

c. CTRL P - If another translation is required, type CTRL P at any time to cause 8TRAN to restart with 

8TRAN Vnn 

> 



8.1.6 Error Conditions 

a. If the command string is not understood, 

?? 

> 

is typed by the translator; a corrected command string should then be typed by the user. 

b. If the name of the program to be translated is not on the input device, 

INPUT FILE NOT ON DEVICE 
> 

is typed, and the command string must be retyped with the correct name. 

c. If the name of the program (with SRC extension) is already on the output device, 

OUTPUT FILE ALREADY ON DEVICE TYPE tP TO RESTART OR CR TO OVERWRITE 

is typed and the user takes appropriate action. 

d. If an IOPS4 error (I/O device not ready) occurs, type CTRL R when the condition has been corrected 

e. Refer to the applicable User's Guide or Software System manual for a description and listing of all 
IOPS errors. 

8.2 COMPACT VERSION 

This version of 8TRAN is an absolute binary paper tape which must be loaded using the COMPACT Loader. 
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8.2.1 Loading Procedure 

Perform one of the following two procedures, depending upon whether you are using the low speed reader (ASR33) 
or the high speed reader (PC- 15) as the loading device for the loader. 

a. Low-Speed Reader 

1 . Set the BANK/PAGE switch to PAGE. 

2. Place the tape containing the Low Speed Hardware Readin Binary Loader in the ASR33 reader. 

3. Set the reader switch to ON. 

4. Set the ADDRESS switches to 7700 (17700 8K). 

5. Press I/O RESET and READIN. When the Loader is loaded, the computer will halt with 777777 
in the AC. 

6. Set the reader switch to OFF and place the 8TRAN tape in the ASR33 reader. 

7. Set the reader switch to ON. 

8. Press START. 8TRAN will be loaded. 

b. High-Speed Reader 

1 . Set the BANK/PAGE switch to PAGE. 

2. Place the tape containing the High Speed Hardware Readin Binary Loader in the PCI 5 reader. 

3. Set the ADDRESS switches to 7720 (17720 8K). 

4. Press I/O RESET and READIN. When loading is complete, the computer will halt with 777777 
in the AC. 

5. Place the 8TRAN tape in the PC 15 reader and press START. 8TRAN will be loaded. 

8.2.2 Initialization Sequence 
When 8TRAN is loaded, it types: 

8TRAN Vnn 
and proceeds to type a series of messages as follows: 

Message Option User Types 

H^To select PC15 
L ) To select ASR33 

i As above 

Y^ Read symbol table. 



*IN 


PC15orASR33 




reader input 


*OUT 


PC 15 or ASR33 




punch output 


*SYM 


Symbol Table 
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NOTE 

The symbol fable tape must be in the reader prior to 
typing Y, and it must be terminated with an EOT 
(ASCII 04) symbol. When finished, 8TRAN types: 

SYMTAB 

N J No symbol table. 



Message Option User Types 



FLG Flag Suppression 



NOTE 



Place the program to be translated in the reader 
before proceeding. 



N ) No suppression, 
proceed with 
translation. 

Y2 Select suppression 
option. List 
flags, t 

r DCA Y) Suppress. 

N) Allow. 
f REL Y) Suppress. 

N) Allow. 
ROT Y) Suppress. 

N^ Allow. 
*SMI Y ) Suppress . 

N) Allow. 
US Y^ Suppress. 

N) Allow. 



8.2.3 Translation 



Translation proceeds automatically after the carriage return () ) which terminates the response to the *US mes- 
sage or after the carriage return () ) following an "N" response to the *FLG message. 8TRAN will restart when 
the current translation is completed. 



t See Paragraph 7 . 3 
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8.2.4 Other Features 

a. PAUSE - When a PAUSE is encountered by 8TRAN, the symbol table is preserved for the translation 
of other tapes. The program types: 

PAUSE 

tP 

Place the next tape in the reader and type CTRL P. 

b. CTRL P typed at any other time will cause the program to restart with 

8TRAN 
*IN 

c. $ - When a $ is encountered the program restarts, as above. 

d. The program may be started at location 100. 

8.2.5 Error Conditions 

There are two conditions that will cause the program to halt in the COMPACT environment: 

a. When the PC 15 paper tape punch is out of paper tape, the program halts at location 70 with all 
ones in the AC. To continue, reload tape into the punch and press CONTINUE. 

b. When an interrupt occurs, not caused by the PC 15 or ASR33, the program halts at location 70 with 
the IORS in the AC. Press CONTINUE to execute a CAF instruction, in an attempt to clear the cause 
of the interrupt. 
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APPENDIX A 
SYMBOL TRANSLATIONS 



PDP-8 



PDP-15 



PDP-8 



PDP-15 





Memory Reference 


AND 




AND 


TAD 




TAD 


ISZ 




ISZ 


DCA 




(DAC 
(CLA 


JMS 




JMS 


JMP 




JMP 


I 




* 



Ignored 



Operate 



NOP 


NOP 


OPR 


OPR 


IAC 


IAC 


RAL 


RAL 


RTL 


RTL 


RAR 


RAR 


RTR 


RTR 


CML 


CML 


CMA 


CMA 


CLL 


CLL 


CLA 


CLA 


HLT 


HLT 


OSR 


OAS 


SKP 


SKP 


SNL 


SNL 





Operate (Cont) 


SZL 




SZL 


SZA 




SZA 


SNA 




SNA 


SMA 




SMA 


SPA 




SPA 




Combined Operate 


CIA 




CMAIIAC 


STL 




STL 


GLK 




GLK 


STA 




CLC 


LAS 




LAS 




Input/Output 


IOF 




IOF 


ION 




ION 


IOT 




IOT 


KSF 




KSF 


KRB 




KRB 


TCF 




TCF 


TSF 




TSF 


TLS 




TLS 


RFC 




RSA 


RSF 




RSF 


RRB 




RRB 


PLS 




PSA 



A-l 



PDP-8 



PDP-15 



PDP-8 



PDP-15 



Input/Output (Cont) 


Pseudo Operators 


PCF 
PSF 


PCF 
PSF 


PAGE \ 
FIELD J 
* 


Ignored 


Floating Point 


DECIMAL 
OCTAL 


.DEC 


FEXT 


Ignored 


.OCT 


FADD 


JMS FAD 


DUBL I 
FLTG J 


Ignored 


FSUB 


JMS FSUB 


TEXT 


.SIXBT 


FMPY 


JMS FMPY 


PAUSE 


.EOT 


FDIV 


JMS FDVD 


$ 


.END 


FGET 


JMS FLAC 


DEFINE 


.DEFIN 


FPUT 
FNOR 


JMS FDAC 
JMS%FNOR 


< 

> 


Ignored 
.ENDM 


I 


XCT 


EXPUNGE 1 




JMS I 5 


fJMS FLIP 
I 


FIXMRI [ 
FIXTAB J 


Ignored 


JMS I 6 


f JMS FLOP 






JMS I 7 


Ignored 







A-2 



APPENDIX B 
FLAGS 



Group 


Descriptor 


Meaning 


Optional 


DCA 

REL 

ROT 

SMI 

US 


A DCA instruction was translated. 

A relative address was encountered. 

A rotate microinstruction was encountered. 

Segmented microinstruction. 

An undefined symbol occurred in the 
operation field. 


Mandatory 


IC nnn 

LIT 

LOC 
MPC 

SE 
SKP 


An illegal character was encountered and 
ignored. 

A literal was nested, or, if translated, 
would have produced extra code. 

A location counter setting was ignored. 

A DUBL or FLTG pseudo-operation was 
encountered and ignored. 

Symbol Table Exceeded. 

An SMI followed a Skip instruction. 
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APPENDIX C 
8TRAN DEMONSTRATION 

The appendix consists of a demonstration of 8TRAN operation in the Advanced Monitor environment. The listing 
in the left column is the MACRO-8 source program to be translated. (For the convenience of the reader, addi- 
tional spaces have been inserted in the body of the listing to align the code.) The column on the right on the 
page is an 8TRAN output listing showing the results of translation. 



NOTE 



Summaries of symbol translations and diagnostic flags 
are provided in Appendices A and B respectively. 



MACRO-8 Program 



/DIGIT OCTAL SQUARE CONVERSATIONAL 
/PROGRAM 



*200 








START, 


C LA 
T L S 


CLL 






JMS 




CRLF 




JMS 




LISN 




TAG 




M260 




RAL 


CLL 






RTL 








DCA 




NUMBER 




JMS 




LISN 




TAD 




M260 




TAD 




NUM0FR 




DCA 




NUMBER 



Translation 





. ARS 






.LOC 


100 


/DIGIT OCTAL SQUARE 


CONVERSATIONAL 


/PROGRAM 






/** -LOC 


*200 




START 


CLA !CLL 
TLS 






JMS 


CRLF 




JMS 


L ISN 




TAD 


M260 




CLLIRAL 




/** -ROT 


RTL 




/** -ROT 








DAC 


NUMBER 


/** -DCA 


CLA 






JMS 


LISN 




TAD 


M260 




TAD 


NUMBER 




DAC 


NUMBFR 



/#* -DCA 



CL A 



C-l 



MACRO -8 Program 



MULT, 



tad 


NUMBER 


CIA 




DCA 


tally 


tad 


number 


isz 


tally 


JMP 


.-2 


DCA 


NUMSQR 



typsqu, 


TAD 


MESAG1 




DCA 


POINTR 




TAD 


M10 




DCA 


FNDCHK 




JMS 


MESAGE 



TYPANS, 


TAD 


M4 




DCA 


DIGCTR 




DCA 


STORE 




TAD 


NUMSQR 




CLL RAL 




UNPACK, 


TAD 
RAL 
RTL 


STORE 




DCA 


STORE 




TAD 


STORE 




AND 


K7 




TAD 


K260 




JMS 


TYPE 




ISZ 


DIGCTR 




JMP 


UNPACK 


TYPOCT, 


TAD 


MESAG2 




DCA 


POINTR 




TAD 


M7 




DCA 


FNDCHK 




JMS 


MESAGE 




JMS 


CRLE 




JMP 


START+2 





Translation 




MULT 


TAD 
CMA! IAC 


NUMBER 




DAC 


TALLY 


/** -DCA 








LAC 


NUMBER 




ISZ 


TALLY 




JMP 


.-2 


/«» -REL 








DAC 


NUMSQR 


/*» -DCA 


CLA 




TYPSQU 


TAD 


MESAG1 




DAC 


POINTR 


/»» -DCA 








LAC 


M10 




DAC 


FNDCHK 


/*» -DCA 


CLA 






JMS 


MESAGE 


TYPANS 


TAD 


M4 




DAC 


DIGCTR 


/«» -DCA 








DZM 


STORE 




LAC 


NUMSQR 




CLL!RAL 




/** -ROT 






UNPACK 


TAD 
RAL 


STORE 


/»» -ROT 


RTL 




/»« -ROT 








DAC 


STORE 


/*« -DCA 








AND 


K7 




Tad 


K260 




JMS 


TYPE 




ISZ 


DIGCTR 




JMP 


UNPACK 


TYPOCT 


tad 


MESAG2 




DAC 


POINTR 


/*» -OCA 








LAC 


M7 




DAC 


FNDCHK 


/»» -DCA 


CLA 






JMS 


MESAGE 




JMS 


CRLF 




JMP 


START+2 



/*« -REL 



C-2 



MACRO -8 Program 



TYPE, 



TSF 






JMP 


.-1 




TLS 






CLA 






JMS I 


TYPE 


CRLF, 









TAD 


K215 




JMS 


TYPE 




TAD 


K212 




JMS 


TYPE 




jmp r 


CRLF 


LISN, 




KSF 






JMP 


.-1 




KRR 






TLS 






JMP I 


LISN 


MESAGE, 









TAD I 


POINTR 




JMS 


TYPE 




IS? 


POINTR 




IS? 


FNDCHK 




JMP 


.-4 




JMP I 


MESAGE 


NUMBER, 







M260, 


-260 




TALLY, 







NUMSQR, 







MESAG1, 


START1 




POINTR, 







M10, 


-10 




ENDCHK, 







STORE, 







M4, 


-4 




DIGCTR, 







K7, 


7 




M7, 


-7 




K260, 


260 




K212* 


212 




K215, 


215 




MESAG2, 


START2 







Translation 




TYPE 



TSF 






JMP 


.-1 


/»* -REL 


TLS 

CLA 






JMS* 


TYPE 


CRLF 









TAD 


K215 




JMS 


TYPE 




TAD 


K212 




JMS 


TYPE 




JMP* 


CRLF 


LISN 



KSF 






JMP 


.-1 


/*» -REL 


KRR 
TLS 






JMP* 


LISN 


MESAGE 









TAD* 


POINTR 




JMS 


TYPE 




IS? 


POINTR 




IS? 


FNDCHK 




JMP 


.-4 


/** -REL 








JMP* 


MESAGE 


NUMBER 







M260 


-260 




TALLY 







NUMSQR 







MESAG1 


START1 




/** -US 






POINTR 







M10 


-10 




ENDCHK 







STORE 







M4 


-4 




OIGCTR 







K7 


7 




M7 


-7 




K260 


260 




K212 


212 




K215 


215 




MESAG2 


START2 




/** -US 
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MACRO-8 Program 



STARTl, 


323 


/S 




321 


/a 




325 


/u 




301 


/A 




322 


/R 




305 


/F_ 




304 


/o 




275 


/ = 


START2. 


240 


/SPACE 




317 


/O 




303 


/C 




324 


/T 




301 


/A 




314 


/L 




256 


/PFRIOH 



STARTl 



START2 



Translation 




323 


/S 


321 


/(J 


325 


/u 


301 


/A 


322 


/R 


305 


/r 


304 


/D 


275 


/ = 


240 


/SPATE 


317 


/ 


303 


/c 


324 


/ r 


301 


/A 


314 


/L 


256 


/RtRlon 


.END 
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INDEX 



.ABS, 7-6 

Absolute binary paper tape, 8-4 

Accumulator Left Shift (ALS), 5-2 

Adding to symbol table prior to assembly, 4-3 

Addition (+) expression operator, 3-2 

Additional code translation, 7-5 

Address 

field, 3-1 
size, 2-2 

Address, relative (Translator), 7-5 

Advanced and Background/Foreground Monitor, 8-1 

loading procedure, 8-2 

Alphanumeric mode, 4-2 

ALS see Accumulator Left Shift 

ALSS see Signed Accumulator Left Shift 

AND (&) expression operator, 3-2 

Arithmetic package, correspondence table, 6-2 

ASCII characters, 7-4 

.ASCII (7-bit ASCII) pseudo-op, 3-3 

ASR33, 8-5 

Assembler symbolic program format, 3-1 

Asterisk (*) 

Multiplication expression operator, 3-2 
PDP-15 indirect addressing, 3-1 
PDP-8 pseudo-op, 7-3, 7-6 

Auto-index registers, 2-1, 2-2 

B 

Bank/Page mode, 4-1 
Basic I/O Monitor, 8-1 

loading procedure, 8-2 
Binary mode, 4-2 
BitO, 6-1, 6-2 
.BLOCK pseudo-op, 3-2 
Brackets see Macro Defining 



CAF (Clear All Flags) instruction, 4-1, 8-7 

CAP-I5, 1-1, 7-1 

Carriage return, 3-1 

Comma (label terminator), 3-1 

Command string for loading Monitor version, 8-2 

Comment field, 3-1 

COMPACT version, 8-4 

error conditions, 8-7 
initialization sequences, 8-5 
loading devices, 8-5 
loading procedure, 8-5 
translation, 8-6 

Conflicting event times, 7-3 

Consecutive addresses, 3-1 

Correspondence between memory reference instructions 
table (mnemonic-octal), 2-1 

CTRL P, 8-4, 8-7 

CTRL R, 8-4 



.DAT slot assignments (Monitor version), 8-1 

Data fields, 2-2 

DCA instruction flag, 7-5 

DDT (Dynamic Debugging Technique), 8-1 

DECtape 

control word format, 4-2 

controllers, 4-2 

data standard format, 4-2 

DEFINE, 7-3 

Device dependent IOTs, 4-3 

Direct addressing, 2-2 

Division (/) expression operator, 3-2 

Division (DIVS) signed operation, 4-1 

(Dollar Sign) $, 8-4, 8-7 

Double precision constants (DUBL) 

Assembler, 3-2 
Translator, 7-7 
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Double rotate instructions, 7-3 

DTDF (Skip if DECtape control flag = 1), 4-3 

DTEF (Skip if DECtape error flag = 1), 4-3 

DTSF (Skip if error flag or DECtape flag = 1), 4-3 



EAE (Extended Arithmetic Element) coding, 1-1, 5-1 

correspondence table, 5-1 
word length, 5-1 

8-bit ASCII characters, 3-3 

8TRAN 

demonstration, C-l 
function definition, 1-1 
operation, 8-1 
versions, 8-1 

Error conditions 

COMPACT, 8-7 
Monitor, 8-4 

Exclusive OR ( \) expression operator, 3-2 

Expression operators, MACRO- 15, 3-2 

EXPUNGE pseudo-operator, 3-3 

Extended Arithmetic Element (EAE), 5-1 

Extension PAL, 8-3 



Field delimiter, 3-1 

space, 3-1 
tab, 3-1 

Fields 

address, 3-1 
comment, 3-1 
data, 2-2 
instruction, 2-2 
label, 3-1 
operation, 3-1 

File name extension, 8-3 

FIXMRI pseudo-op, 3-3 

FIXTAB pseudo-op, 3-3 



Flag suppression, Monitor version operation, 8-3 
Flags, B-l 

Input/output, 4-1 
Flags, Translator 

Mandatory, 7-6 

illegal characters, 7-6 

literals, 7-7 

location counter settings, 7-6 

multiple precision constants, 7-7 

skip instruction, 7-7 

symbol table overflow, 7-7 

Optional , 7-5 

additional code, 7-5 

DC A, 7-5 

relative address, 7-5 

rotate instructions, 7-6 

SMI (segmented micro-instruction), 7-5 

undefined symbols, 7-6 

Floating point 

arithmetic format, 6-1 
constants (FLTG), 3-2, 6-2, 7-7 
correspondence between arithmetic packages 

table, 6-2 
indirect addressing, 6-2 
input/output, 6-2 
instructions, 1-1 
translator, 7-4 
variable storage, 7-5 

FLTG see Floating point constants 

.FSTAT system macro, 8-1 



Highspeed reader (PC-15), 8-5 

I 

Illegal characters (IC), 7-6 

Inclusive OR (!) expression operator, 3-2 

Indirect addressing 

assembler, 3-1 

floating point arithmetic, 6-2 

memory reference instructions, 2-1, 2-2 
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Indirect reference, 3-1 

Indirect references and auto-index registers, 2-1 

Initial character (MACRO-15 Assembler), 3-2 

Initialization sequence (COMPACT), 8-5 

Input/Output (I/O), 4-1 

Floating point arithmetic, 6-2 

Input/Output instructions 

reader/punch, 1-1 
Teletype, 1-1 
translator, 7-2 

Input/Output Read Status (IORS), 4-1 

Input/Output routine calls, 7-4 

Input/Output Transfer instructions (IOT) - 
Teletype, 4-2 

Instruction fields, 2-2 

Integers 

signed, 3-2 
unsigned, 3-2 

Interpreter entry, 7-4 

Interrupt 

buffer, 4-1 

COMPACT environment, 8-7 

function enabled (ION), 4-1 

structure, Input/Output, 4-1 

ION see Interrupt function enabled 

IOPS error, 8-1, 8-4 

IORS see Input/Output Read status 

IOTs in permanent symbol table, 4-3 

IOT (Input/Output Transfer) instructions, 7-2 



JMS FLIP, JMS FLOP, 7-5 



Keyboard fiag is cleared (KCC), 4-2 
Keyboard Reader Select (KRS), 4-2 
KRB see Read Keyboard Buffer 



Label field, 3-1, 7-1 

Labels without code, 3-1 

LAW instruction, 2-2 

LAW N mnemonic, 2-2 

Link, 4-1 

Linking Loader, 8-1 

Literals (LIT), 3-3 

nested, 3-3, 7-7 
page zero, 3-3, 7-4 
translator, 7-4 

LLSS see Signed Left Shift 

Loading devices for COMPACT version, 8-5 

Loading procedures, Monitor 

Advanced and Background/Foreground environ- 
ment, 8-2 
Basic I/O Monitor environment, 8-2 

Location counter, 3-2, 7-3 

Location counter settings (LOC), 7-6 

.LOC 100, 7-6 

Low speed reader (ASR33), 8-5 

M 

Macro defining (translator), 7-3 

MACRO-8, 1-1, 7-) 

MACRO-15, 1-1, 7-1 

Mandatory flags, Translator, 7-6 

Mantissae, 6-1 

Memory protect, 4-1 

Memory reference instructions 

Assembler, 3-3 

table, octal-mnemonic correspondence, 2-1 

Translator, 7-1 

Monitor versions operations, 8-1 

MPC see Multiple Precision Constants 

Multiple Precision Constants (MPC), 7-7 

Double precision integers (DUBL), 7-7 
Floating point constants (FLTG), 7-7 
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Multiplication (*) expression operator, 3-2 
Multiplication (MULS) signed operation, 5-1 



N 



Negative mantissae, 6-1 

Nested literals 

Assembler, 3-3 
Translator, 7-7 

Numbers (Assembler), 3-2 



Operate instructions table, correspondence between 
PDP-8and PDP-15, 2-2 

Operate instructions, Translator, 7-3 

Operation field 



Assembler, 3-1 
Translator, 7-1 

Options, Monitor version, 8-3 



Packing of characters, 3-2 

PAGE pseudo-op, 7-3, 7-6 

Paging, 2-2 

Page zero indicator (Z), 7-1 

Page zero literals, 3-3, 7-4 

PAL D, 1-1, 7-1 

PAL III, 1-1, 7-1 

Parameter assignment 

Assembler, 3-3 
Translator, 7-4 

Parameter (P) option, 4-3 

PAUSE (pseudo-op) 

COMPACT version, 8-7 
Monitor version, 8-4 

PC 15 (high speed reader), 8-5 



PC 15 paper tape punch out of tape, 8-7 

Percent sign (%), 3-2 

Period (.)/ 3-2 

Permanent symbol table IOTs, 4-3 

Pseudo-operators 

.ASCII, 3-3 
*, 7-3, 7-6 
.BLOCK, 3-2 
DUBL, 3-2 
EXPUNGE, 3-3 
FIXMRI, 3-3 
FIXTAB, 3-3 
FLTG, 3-2 
PAGE, 7-3, 7-6 
PAUSE, 7-6 
.SIXBT, 7-3 
TEXT, 7-3 

Pseudo-operations, Translator see Translator pseudo- 
operations 



Reader/punch functions, 4-2 
Reader/punch instructions, 7-2 
Read Keyboard Buffer (KRB), 4-2 
Relative address error (REL), 7-5 
Relocatable binary paper tapes, 8-1 
Rotate instructions (ROT), 7-6 



SE see Symbol table Exceeded 

Segmented micro-instruction (SMI) flag, 7-5 , 7-7 

Semicolon (delimiter), 3-1 

7-bit ASCII (.ASCII), 3-3, 7-6 

Shifts in multiplication and division, 5-1 

Accumulator Left Shift (ALS), 5-2 

Signed Accumulator Left Shift (ALSS), 5-2 

Signed Left Shift (LLSS), 5-2 

Signed integers, 3-2 
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Single rotate instructions, 7-3 

6-bit trimmed ASCII, 3-2 

.SIXBT pseudo-op, 7-3 

Skip if DECtape control flag - 1 (DTSF), 4-3 

Skip if DECtape error flag = 1 (DTEF), 4-3 

Skip if error flag or DECtape control flag = 1 
(DTSF), 4-3 

Skip instructions (SKP), 7-7 

Space, 3-1 

SMI see Segmented micro-instruction 

SRC file name extension, 8-3 

Standard device handlers for I/O functions, 8-1 

Statement delimiter, 3-1 

carriage return, 3-1 
semicolon, 3-1 

Status registers, 4-3 

Subdevice selection, Input/output, 4-1 

Subtraction (-) expression operator, 3-2 

Symbols (Assembler), 3-2 

Symbolic source tape (or file), 7-1 

Symbol table 

MACRO- 15, 3-3 
Monitor version, 8-3 

Symbol table 

capacity, 7-7 
exceeded (SE), 7-7 
overflow, 7-7 

Symbol translations, A-l 



TEXT pseudo-op, 7-3 

Text handling 

Assembler, 3-2 
Translator, 7-3 

Translation 

COMPACT version, 8-6 
Monitor version, 8-3 

Translator, 7-1 

floating point, 7-4 
input/output instructions, 7-2 
literals, 7-4 

memory reference instructions, 7-1 
operate instructions, 7-3 
pseudo-operations, 7-3 

Translator program 

formats, 7-1 
functions, 7-1 

2's complement, 6-1 



U 

Undefined symbols (US), 7-3, 7-6 
Unsigned integers, 3-2 
User macros correspondence, 3-3 
User symbol table, 7-6 



Versions of 8TRAN 

Advanced and Background/Foreground 
Monitor, 8-1 
Basic I/O Monitor, 8-1 
COMPACT, 8-1 



Tab, 3-1, 7-1 

Tape standard data format table, 4-3 
TC01 DECtape controller, 4-2 
TC02 DECtape controller, 4-2 
Teletype IOT instructions, 4-2, 7-2 
Terminating pseudo-ops, 3-3 



Z see page zero indicator 



HOW TO OBTAIN SOFTWARE INFORMATION 

Announcements for new and revised software, as well as programming notes, software problems, and documenta- 
tion corrections are published by Software Information Service in the following newsletters. 

Digital Software News for the PDP-8 Family 
Digital Software News for the PDP-9/15 Family 
PDP-6/PDP-10 Software Bulletin 

These newsletters contain information applicable to software available from Digital's Program Library. 

Please complete the card below to place your name on the newsletter mailing list. 

Questions or problems concerning DEC Software should be reported to the Software Specialist at your nearest DEC 
regional or district sales office. In cases where no Software Specialist is available, please send a Software Trouble 
Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 1 754 

These forms, which are available without charge from the Program Library, should be fully filled out and accompa- 
nied by teletype output as well as listings or tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual and appropriate topics of general interest will be printed in the newsletter. 

New and revised software and manuals, Software Trouble Report forms, and cumulative Software Manual Updates 
are available from the Program Library. When ordering, include the document number and a brief description of 
the program or manual requested. Revisions of programs and documents will be announced in the newsletters and 
a price list will be included twice yearly. Direct all inquiries and requests to: 

Program Library 

Digital Equipment Corporation 

146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

Digital Equipment Computer Users Society (DECUS) maintains a user Library and publishes a catalog of programs 
as well as the DECUSCOPE magazine for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 

Send Digital's software newsletters to: 



Name 

Company Name. 
Address 



My computer is a PDP-8/I Q PDP-8/L Q 

LINC-8 D PDP-12 D 

PDP-9 D PDP-15 D 

PDP-10 D OTHER D 

My system serial number is_ (if known) 



(zip code) 
Please specify 
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READERS COMMENTS 



Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness of its 
publications. To do this effectively we need user feedback - your critical evaluation of this manual. 

Please comment on this manual's completeness, accuracy, organization, usability, and readability. 



Did you find errors in this manual? 



How can this manual be improved?. 



DEC also strives to keep its customers informed of current DEC software and publications. Thus, the following period- 
ically distributed publications are available upon request. Please check the appropriate boxes for a current issue of the 
publication(s) desired. 

D Software Manual Update, a quarterly collection of revisions to current software manuals. 

D User's Bookshelf, a bibliography of current software manuals. 

D Program Library Price List, a list of currently available software programs and manuals. 



Please describe your position. 



Name Organization 

Street Department . 



City State Zip or Country 



